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GENERAL DESCRIPTION 

The £1800/81700 data communications subsystem provides an 
interface between the network controller and any executing MCS on 
the systeme The character-oriented header informatton which the 
MCS reads or writes in its communication with the network 
controilers» the remote files tn its own networks and the cP 
basically constitutes the MCS interface that is described in this 
product specification. MCS interface is composed of the various 
messages required for any queries or changes in the status of 
remote stattons. : 


The minimum requirements for this datacomm environment are an ADL 
handler and a user program which opens a remote file with headers 
tan ACS). There 18 no restriction on the number of remote fites 
with headers that may be opened on the system» although there 1s 
a maximuc of 20 remote files that can be concurrently associated 
with any one statione In a system composed of several MCSs» a 
station say tbe associated with more than one of them in a 
hierarchical manner. | | 


In general» the network controller handles the line protocols and 
the MCS in cooperation with the network controller» handles the 
attachment of remote stations to their respective remote files. 
kKemote file I/0 standard to the 8180)9/681700 systems 15 controited 
by the operating system through a queue file mechanism that is 
transparent to the user and therefore not discussed tin this 
documente- 3 


An MCS program wilt fulfiltt some or atl of the following data 
communications needs; | 


- Message switching 


- Logical attachment of a station to a remote application 
program or system of programs | 


“- Network reconfiguration 
_* Audit and recovery 
= Network statistical analysis 


- Communication with the operating systeme 


REMOTE FILES 

Remote files are the means by which programs use the NOL datacomm 
subsystem to transfer information from remote terminals to user 
programs Cor vice versa). MCS"type remote files are 
distinguishea from ordinary remote files only by the special 
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headers that allow them to affect the flow of messages- 


MCS interface is enabled by opening a remote file with headers 
that has an external fite name which matches a file declared in 
the file section of the executing retwork controlter. Atl 
stations tisted in the family statement for that file are 
controlled by the NCS. The 5O-byte header that precedes data 
messages allows the ACS to access tatlies» toggles and other 
information relevant to the station originating the message. 
Non-data messages consist only of the variable-length header. 


Ouamy remote files» tvxeee with no stations specified» are allowed 
as tong as the program opening the dummy remote file (Cwithout. 
headers) has been 21ptexecuted Oy an MCS "type orogram. The MCS 
is expected to direct the assignment of stations to that file by 
approving or disapproving the open of any remote station that 
wishes to be attacneag to that file. | 


Khere multiple MCSs are executing on the same systems there ts an 
established protocol which allows one MCS to attach stations to 
anothere The protocol is Dased upon the concepts of “primary” 
and "secondary" and these terms refer to the relative 
responsibilities of two SCSs in the control of a remote station. 


Since users may sign on or attach to a series of MCS-tyne files» 
primary files Cwith some restrictions noted below) are 
Gistinguished from secondary files only oy stgnal characters and 
Dy their relative positions in the master list of attachments 
kept for each station in the remote networks. The primary file ts 

the tlast remote file on the master tist to which the station 1s 
attached and the secondary file is the next~totlast. Uy default» 
all interface messages go to the primary files and» if the first 
character of the message matches the signal character defined for 
the secondary fite Catt secondary fites aust have a signal 
character)» the message goes to the secondary file. The 
advantage of this configuration is that a remote station can 
still communicate with the secondary file even though 1t has 2 
primary attachment to another remote file. 


Secondary . files are restricted to remote fites opened with 
headers since they must have signal characters associated with 
thems and primary files may De etther ordinary remote files or. 
remote files opened with headerse- In a series of remote 
attachments done by an individual station» there is a limit of 
one attachment tc a remote file without headers: it must be the 
primary file. If alt of the attachments are to ACS~type remote 
files» there is a Limit of 2) attachments for one remote station. 


Primary and secondary protocot is maintained through .a master 
List that is updated by the network controller each time a remote 
station attaches or detaches itseitf from an MCS or a remote file. 
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When a station stgns on or attaches to aremote filer» ithe 
filename is added to the lLtst and a signal character 15 
associated with it if it tis an MCS. If a third attach/sign on is 
made» the primary and secondary cesignations are reconfigured. 
After redefinitton»s the original MCS does not have any current 
responsidilities where the remote station is concerned and is 
inaccessibie from that station. 


When a remote station is detached or closed» the tast entry 15 
deleted from the lttst and primary and secondary are reconfigured 
from the master liste. In this ways» the original MCS Cin a Series 
of three attaches) 15 maintained on the tist and the finat 
close/detach must ue from the first (Coriginal) MACS. MCSSs 
designed to inhibit the primary"secondary cption do so by denying 
alli opens on remote files with headers. | 


This subsection defines most of the basic terminology that 1s 
used in this product specificatione It also references related 
publications that would be helpful to those who are unfamiliar 
with those terms and concepts. 


MCS | Message Control System = Any progrem 


which opens a remote file with the 
header option and thereby controls the 
stations in that remote file. 


nC Network  Controtler - The program 
generated through compilation of an NOL 
(Network Definition Language) program. 
The NC handles the tine disciptine’ for 
the data communication devices of a 
system and interface queue between C5 
and operating system. Refer to °.S. 
2212 52235 B1800/81700 NOL and 1073715» 
NOL Reference Manual. 


kKemote File | A file declared in a program whichse in 
—— -conjunction with the network controller» 
provides input» output or 1/0 with a set 
of data communitcation devicese ekefer to 
Ps Ss 2212 54625 3186039/51700 maCPII and 
1089992» Data Communications Information 

Manual. 


Headers An option on aremote file which allows 
| system control functtons and provides a 
20°hyte header on atl data messages 

moving through that remote file. 
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Tne file to which a station was most 
recently attached or includeaq in an 
Opene Normal input goes to the primary 
file. 


The file to which a station was just 
previously attached or included itn an 
opens iee@er the penultimate attachment. 
The secondary file must have headers and 
wilt have approved the attach or open of 
the primary file. | Input whose first 
character matches the signal character 
(not blank) designated in the primary 
file's attach or open will yo to the 
secondary file. | 


(CRF) is the file with headers to which 
a station was most recently assigned» 
either with an attach or with an opene 
If the primary fite has headers» it is 
the CRF otherwise» the secondary file 
is the CRF. 


is the file which writes an attach. 


normally denotes 4a program which has 
opened or iS opening a_- remote file 


‘without headers. 


Logical Station Number ~ The number ody 
which the network controtler uniquely 
identifies a station for normal 
transactionse LSN's begin with 709001" 
and proceed sequentiatly through alt the 
stations deciared in the Station section 
of the NOL controller. 


Relative Station Number - is the numcer 
by which a user program with a remote 
file using a remote key uniquely. 
identifies a station. An RSN equal to 0 
implies a control messagee An RSN equal 
to l implies the first station in the 
file's family statement. KSN*®s5 proceed 
sequentially through the stations 
delineated by a file's family statement» 
except that a controlling remote file 
may modify the LSNeLIST and thereoy 


modify the RSN's of the remote file. 1 f 


a station is detached from a file with a 
remote key» the KSN's remain unchanged. 
if a station is attached to a file with 
aremote key» the new &SN will be tts 
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old SN tf it were attached previously: 


Otherwises it will be one larger than 


the greatest SN previously associated 
with the tite. | 


NAME NUMBER 
B1800/81700 Network Vefinition Language PeSe 2212 5223 
£B1800/81700 WCL/Library PeSe 2212-5215 
(31800/81700 HOL Reference danuat 1073715 
Data Communications Keference Manual | 1089992 
61800/681700 Cata Comm Audit | PeSe 2212 5421 


PeSe 2212 5462 
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MESSAGE IYPES 
This section specifies the record formats of the messages read 
and written ody the MCS as tt communicates with both the network 
controttler and tne remote stations in its remote file. 


There are three types of record formats: data» control and 
user-defined. Data record format is used in the transfer of 
information Oetween network controtlers and remote stations and 
in this area the MCS may read or write the records depending on 


the source and destination of the message. Controt records dare 
defined by name and represent a specific purpose and actions 
@eges a detacherepl y. Jsertdefined record format 1s used for 


communication between an MCS and a user remote file without 


‘headers ands as its name indicates» jit allows the user program to 


estaolish the purpose of the communicatione 


Att messages read and written by an MCS are listed by type and 
format. 


Table 2-1 MESSAGES READ 


MESSAGE | TYPE FORMAT 


QGUIPUT MESSAGE Cfrom REMOTE FILE) “o0" DATA 
INPUT MESSAGE Cfrom STATION) | wo). ~ DATA 
INPUT LCOGICALACK : 02" | DATA 
GOUDeRESULTS.~REPLY "Og" DATA 
KECALLED.MESSAGE oe "Oo" DATA 
UNPROCESSECeUUTPUT MESSAGE “QO7" DATA 
UPN e1o,7 CUNTRUL 
ATTACH © |  "™i2" CUNTROL 
ATTACH.REPLY | w137 CUNTRIL 
DETACH "14" CONTROL 
JETACH. REPLY “158 CONTRuUL 
CLUSE "15" | CUNTROL 
STATUS.REPLY . | more ~~ CUNTRGL 
~CHANGE.REPLY “235° CONTROL 
RECALL.~REPLY nose CONTRUL 
KEMOVE.REPLY wala CONTROL 
KREMCTEFILE. INFOUREPLY weg" CONTRGL 
LINE.RELEASE REPLY | | wz i" CUNTR EL 


KEMOTEsFILEsINTERCOMMUNICATIGN "50" - "99" USER-DEFINED 
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Table 2-2 MESSAGES WRITTEN 


MESSAGE | TYPE | FRAT 
UUTPUT MESSAGE (to STATIGN) eG" DATA 
INPUT MESSAGE Cto REMOTE FILE) "Oi" DATA 

L UGICALACK.REPLY "935" DATA 
GUTPUT GCOL.RESULTS "4" DATA 
GPENeREPLY yi" CUNTROL 
ATTACH "12" CONTROL 
ATTACH.REPLY | ae CUNTROL 
DETACH 724" CONTRUL 
STATUS "25" CUNTRUL | 
CHANGE "22° CONTRGUL 
RECALL "Oho CUNTRGL 
REMOVE "25R 7 CUNTRUL 
REMOTEsFILE. INFO | | "9B% CUNTROL 
LINE.RELEASE "3g" CUNTROL 
REMOTEFILES INTE RCUMMUNICATION “So = "OO" USER"DEFINED 


In Tables 203 through ‘%Sel» the following abbreviations and 
notations are used: 


NC = Network controller/operating system interface 
MCS = Remote file with HEADERS 
USER ~ Remote file without HEADERS 
R&R * Read 
W =~ Write 


we" under a "“N"™ implies that tt is appropriate for that progran 

| to SET that field. | 

"*" under an "Rk" implies that it is appropriate for that program 
to READ that field. . | 

"#" under a "“W" amplies that it is mandatory for tne MCS to SET 

, that field oefore sending the message. 

“9" implies a numeric ESCDIC character field (sit &) 

"X"™ yaplies an EBCDIC character field CRit @) 

"#" denotes iterations of the same fields» one for each 
remote station | | 
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DATA HESSASES 
The types of data messages which an 4CS ceads and writes are as 
follows: 


TYPES WRITTEN DESTINATION ANC FUNCTION 


00 : An output message to any station tn its 
remote file. | 


O1 | An input message to any remote file. The 
destination of the message iS indicated dy 
the number in the remoteefileeno field. . 


v3 A tlogicalack.reply message to the network 
| controller. This message shoutd attow the 
relevant request to acknowledge receipt of 

the message via an ack to the station. 


04 A good-eresults message to the network 
controller. This message acts like an output 
message except that positive receipt of the 
message by the station produces a 
gooderesultsereply. | 


TYPES wWEAD | GRIGIN AND FUNCTION 


u0 | An output message from a remote file whose 
open it approved with participating set to 
wy. . . : 
01 An input message from one of the following: 
A primary station when the stgnat 


character is not used. 


A secondary station when the signal 
character designated in the open or 
attach or attachereply is the first 
character of the message. 


A remote file with headerse 
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The data message 


MESSAGE. TYPE 

WARIANT 

LSN 

TEXTA-SIZE 

REMOTEFILE.NO 

TIME | 

TRAN.NO 

ERaOn 

TALLYS 

TOGGLES 
~TEXMINAL.TYPE 
FILLER 7 

TEXT 
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An input logicalack message from the network 
controlter. This message 1s received when a 
request executes 2 terminate fogicalack. If 
the primary has headerss it receives tnis 
messages otherwisepe if there ts a secondary 


file it gets the message. 


A good.eresultserepty message from the network 
controller 15 received upon successful 
transmission of an output message to 4a 
statione The message is recetved only if the 
gooderesults Git tn the message or station 
Was sete If the primary remote file has 
header Sp this message is received Dy the 
primary files otherwise» the secondary file 
receives ite 


A recalledemessaqge from the networ k 
controtter. Recalled.messages follow the 
recail.repiy message. The number of recatied 
messages is indicated in the recall-ereply. 


An unprocessedeoutput message from the 


network controller. When the network 
controttler is DSed» it sends output messages 


to the appropriate controtling remote file 
before sending an EOF. 


format is defined as? 


NC=i 


% 


Table 361 DATA RECORD FURMAT 


ACS MCS*NC Mv, 

R W R W EA W R PIC 
* + * + (we) (®) * 99 
* * of & - - y 
* * * * (*) (*«) * 399 
& + % + («) (*) tt I3€4) 
te x te + ae ~ 999 
* = = 9C7) 
* - 7 999 
* = = XX 
& * te = si 9€9) 
* * & = = 9035) 
* = = 99 

| X€o) 
k & & rs & te 


CS~USER USER=MCS FLELD LENGTH 


XCTEXT.SIZE) 
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The parenthesized fields in Table 5-1 for user remote files 
indicate the three fields in the remote key. The remote key has 
the following format: 


KSN 9(€3) 
TEXT-SIZE 9C€4) 
MESSAGE.TYPE 9¢€3) 


RSN iS converted to LSN by the remote file interface. 


The semantics of the fields in the header are: 


WARTANT A field indicating the followtng: 
= 1 -~ make program memory resident 
= 2 == make program disk resident 
= 3 -= cause EGF branch 
= 4 == cause exception bdranch 
= 5 -= include text in gooderesults.reply 

Sw The logical station numser to which the 
data bdelongse It must be set on output 
and gooderesults messagese 

TEXT»£SIZE The number of characters in the text 

: field. 

sEMOTEFILEND The number of the remote file where the 
message came from or 18 going” t0-« Tt 
must be set on input messagese 

TIae The time in 29*bit counter format when 
the network controller processed the 
messagese 7 

TRAN.NO ee The transmission number that telongs to 
the messagee 

ERROR | A 1lo7bit field extracted from the result 

j descriptor which indicates exception 

conditionse The meaning of the Dits of 


this field are as follows Cbit J=most 
significant bit): 


BIT EXCEPTION 

© parity error 

1 vuffer overflow 

2 read memory parity 
3 time out 

4 break 

5 end of buffer 
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5 foss of USK 

7 toss of carrier 

§ address error 

9 translate error 
1g format error 

11 read not ready 

12°15 not used 
The semantics of tatty» toggle and 
terminal.type are the Same as an 
previous reteases: the tatty fteld 
represents the first three  statton 


tallies tn 3*character decimal format. 
The toggle field represents the first 
eight station toggles as "0" or "1". 
Terminal.type 1S the twordigit 
designation that identifies each class 
of terminal se 


The character string which is ordinarily 
displayed on the remote screen or the 
tocait operator display terminal CODT). 
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CONTROL 4ESSAGES 


am <08n enh aon oe a) ah a cmp ap am cm 


UPEN MESSAGE 


The open message is the mechanism for creating new remote files. 
The operating system receives an open from a program and 
determines that the device is a remote file. A remote file open 
message 18S then toraulated and passed to the network controller 
which takes the followtng actions: 


1e If the file is knowns it modifies the message to indicate 
the appropriate station list, if unknowns» the open 15 
disapproved with file missing. | 


2e Verifies that the open message 1s valid. If not» it 
disapproves the open. 


3- If none of the stations tin the open are assigned to an 
MCS» it approves the ocpen and creates a new remote file. 


4 If some of the stations in the open are assigned to one 
MCS and the rest are unassigned» it forwards the oapen 
message to the MCS. 


5-e If the stations in the open are assigned to more than one 
MCS and the program attempting the open was not 
Zipmexecuted» it disapproves the open with file tocked. 


be If the program whose open 18S bdeing processed was 
Zipmexecuted by an MCS» then the list of stations in the 
open 1s examinede If atl the stations in the List belong 
to a different MCS» then the open 1s forwarged to that 
program. If a discrepancy exists» then the onen 15 
forwarded to the MCS that zipped the program. 


7e- If it is a dummy file with headers but was not 
Zip~executed by an MCS» the open is approved. 


&- If it is a dummy file without headers and the program was 
not ziptexecuted by an MCS» it wilt be disapproved. This 
is done oecause there is no way to attach stations to the 
remote file after the open. 


GPEN REPLY 
If the open 1s passed to an ACS» an openereply 15 expected. The 
MCS must approve or deny the opene [t may» in additions modify a 
number of other fields as specified in the diagram on the open 
format Cunder ACSW). If a denial is sent» no changes wilt De 
made»s the deniat will be forwarded to the operating system which 


q~? 


ante 
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wiit deny the open to the opening program. A signal character 


Indicated in the open-ereply enables the statton to communicate 


with the MCS.~ If openetype is output cr if participating ts set» 
no changes will be made to primary or secondary assignments. 


Lf both participating and headers are set» the open wilt ode 
disapproved vy the network controtter and‘a close with openeerror 
set will be dispatched to the #CS. 


When the network controtler receives an open.reply from an MCS» 
it rechecks alt fields relevant to itself and the operating 


Systeme If the MCS made an error in formulating the reply» the 
approval witt oe changed to denial anda close witt be sent to 
the MCS with open-error = "1". Otherwise» the new remote’ file 


will be created and the reply forwarded to the operating system. 


An ANCS may approve an open with the headers option sete 
indicating another ACS. At this times» the primary file ts the 
fite whose open was approved and the secondary file is the file 
which approved that open. All messages whose first character is 
the designated signat character go to the secondary file. Atl 
others go to the primary filee Then» if the second 4CS aporoves 
an open with that station or attaches that station to a third 
remote file» the first MCS 1s left outs the second MCS becomes 
the secondary file and the new remote file becomes the primary 
file. | 


An example of secondary attachment would be a station running 
under the ittlustrative MCS which first signs on to a special ALS 
which» in turns retrieves certain types of information from. a 
data tase on command and then from the second 4CS stgns onto an 
inventory review programe As the user reviews the inventory» he 


may at any time type in his signal character and query his data 


base through the special-purpose MCS. In order to contact the 
illustrative MCS» howeverr he must first sign off from the 
inventory review program. | 


An example of a participating open would te ae station running 
under the illustrative MCS signs onto 4&@ speciati MCS which formats 
messages according to terminal type» sets up forms» displays data 


attractively» etCer and from this second “tS signs onto the 
inventory review program. The second open 1S approved with 
participating set to "1". In this case» primary messages are 


sent to the speciai MCS and secondary messages stilt go to the 
iltustrative MCS. 
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QPEN WITH SIMPLE HEADERS 
A emote tile with SIMPLE_HEADERS is used as a headers file with 
a few exceptions. 


A SO™byte message header must be pretixed to every message sent 
or received dy the program using the files The only exception to 
this is that the result of a “TERMINATE ERKDR" done by the NC 
caused an “ON EXCEPTION” condition to be set for the file» as 
with a siepte remote file» instead of the usuat procedure for a 
headers file. : 


A SIMPLE_HEADERS file wilt not receive unsolicited responsess 
that is» no UPEN» CLUSEs ATTACH» DETACH» or LOGICALACK messages 
witlt be queued for the file. 


A SIMPLE_HEADERS file may set TALLIES and TuGGLcS in the message 
header» as well as issue GOUOCD_RESULTS» REMOTE _Fitc INFO» and 
STATION_STATUS messages» but may not write ATTACH» GETACHs 
CHANGE» RECALL» LINE_RELEASE or COBJL74"related messages. CALL 
COUVOL74 QUEVES will be SIMPLE_HEADERS files.) 


Une more difference between SIMPLE_HEACERKS and full headers files 
is that in the case where the QOPEN for a remote file with 
SIMPLE_HEACERS is forwarded to an MCS» the WCS may approve the 
UPEN with "PARTICTIFATING® set. 


If the MCS approves an open with current stations = 0» then the 
open wilt Ge approved with no stations initially attached. Each 
message directed to that remote file wilt cause the CP to 
determine whether the LSN<">RSN association has been estabdtished 
already inthe FlIsb and establish it if necessary. The message 
will then be processed as usual. This facility allows a remote 
file to be opened with no stations attached initially and 
messages then to be sent Cunder direction of the approving MCS) 
to the file without the indicated station having been explicitly 
attached by the MCS to the remote fite. 


The tormats for the open and openereply messages are shown below. 
Included are indications of relevant fields and following 1s = Aan 
explanation of each field's meaning. 
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Table 4.1 OPEN/OPEN-REFLY 


NC7MCS MCS“NC 

W R W i PIC 
MESSAGE .TYPE * * + x 99 
UPEN.e TYPE * * 9 
OPEN.TIME te & 907). 
PAKRENT.JCENG * 9(7) 
PROGRAM.J03~- NO * * 9(7) 
PROGRAMsNAME * * X( 30) 
HEADER.OPTION * * 9 
SIMPLE -HEACER-OPTION * * & fs 9 
USE -HEMOTE.KEY & * 9 
RESIUENT & * tk 9 
USERSREMOGTEeFILE-NG * te 999 
SIGNAL-CHAR fe & 4 
APPROVE.DENY + t 9 
VENIAL.»REASON + * 9 
PARTICIPATING x 9 
GOGD.RESULTS * * 9 
MAX-STATIONS & te 999 
CURRENT.STATIONS * * * * 999 
LIST.~TYPE * & 9 
FILENAME tk * X¥€10) 
PROTOCOL.TYPé& * * 99 
SESSION * & | 9999 
STATICN.LIST x * te * 999C CURRENT. 


29TATIONS) 


The semantics of the fields of the open message are as follons: 


UPEN- TYPE 3 Indicates the directions of data flow 
| allowed the remote tile: 


"1" -- input only 
nov == gutput onty 
ws" == input/output 


OPEN-TIME The time at which the MCP recognizes the 
file open. 


PARENT.JCB.NO © | The joo number of the program. that 
, Zipmexecuted the program opening” the 
remote file or 0000000". 


PROGRAMeJOB-NO The job numoder of the program opening 
the remote file. 


PROGKAMLNAME The name of the program opening the 
remote file. 


GURRUUGHS CORPURATION 
COMPUTER SYSTEMS GkOUP 
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HEADER OPTION 


STAPLE -HEADER-UPTIUN 


USc ekEMCTE KEY 


RESIDENT 


USEReREMOGTEF ILc eNU 


SIGNAL* CHAR 


APPROVE.CENY 
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A boolean iudicating whether the file its 
allocated with MCS-type headers and 
functionse 


A boolean whiches when set along with 
HEADEReUPTION» indicates to the WC that 
simple headers are to be used. 


A boolean indicatiny whether the _ file 
includes the key option. The remote-key 
option allows writes to specific 
Stations and on reads indicates the 
station which sent the current messagee 
For files without headers» stations are 
identified by relative station mnuabders 
CRSN*s). 


A vatue indicating what to do on a read 
with no data: 


"i" -- keep projram in memory 
"2" == roll program out to DISK 
"3" == provide EQF branch 


The togical fite numver which the 
network controlter uses to identify the 
opening file throughout the remote’ file 
interface. The MCS must not change this. 
field. 


Used Dy the network controller to 
identify messages intended for the KCS 
from a statione #Blank implies no signal 
character. 


Indicates to the operating system 
whether the open should be approved>s 
"1" implies open approval. 


BUKRUUGHS CORPORATION 
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DEWIAL-eREASON 


CENTAL-REASONS 


PARTICIPATING 


bUGDeRESULTS 


MAXeaoTATIONS 


— CURRENT.STATIONS 
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Indicates tne reason for an open denial. 
The DENTAL.~RZEASON may be set by an MCS 
to any of the following Csome have no 
Logical meanirg to an MCS): 


MEANINGS | 4CP REPORTS ASS 

No reason NQ REPURT 

File missing FILE-MISSING 

File tocked FILE~LUCKEO 
Adapter missing FILE «MESSING 

MCS denies FILE -LUCKED 

No room in WC for FILE.LUCKED 
remote file 

Invalid LtSN list FILE.4ISSING 

Too nested FILE e-LUCKED 

MCS missing | NO REPORT 
Invalid station count NO REPURT 

A Dootean indicating whether the 
approving MCS will participate in the 

user program's I[/iU.- It is set Dy the 


approving MCS and causes alt input fron 
the station and all output from the 
remote file to be sent to the «pproving 
MCS rather than the user programe. No 
changes are made to the primary of 
secondary files of the stations in 4 
remote file open with participating set 
to *1". 


Set by the MCS to indicate that the 
network controller should return 
gooderesults messages upon successful 
transmission of data messages to the 
stattione 


The number of stations that can De 


attached to a given fite. Tt ais set Dy 
the program attempting to oapen the 
remote file as part of the file 


declaration. 


The number of stations that are in the 
station.list to be ortyinatly attached 
to the file. Currentestations equal to 
"000" indicates a dummy file. This 
creates a fide which only the approving 
MCS Cor any MCS gaining knowledge of its 
remote file number) may talk to» anda 
which stations could later be attached 


| CO06« 
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LIST.TYPE 


FILENAME 


PROTUCOL.TYPE 


SESSTON 


STATIONeLIST 
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Indicates the method by which the user 
program specified his remote file. fhe 
values of this field can be: 


"“O" == file name 
"1" -- station tist by name 
"2" == station List by LSN 


Type "0" is the only one currently 
implemented. | 


A fiel¢ providing the file name given dy 
the user orogram. This name must match 
a fite name declared in the file section 
of the NDL program which generated the 
controtler untess the user program was 
executed under control of an MCS. If 


the file name given does not exist and 


the user program is under controt of an 
MCS» then the open will be passed to 
that MCS. Howevers the file name is not 
a unique file identifier. The stations 
in a given NOL file say be modified so 
as to be shared by two remote files or 
passed on to another remote fite with 


the same name. In future releases» 
files may also oe designated oy station 
List» so reliance on file names to 
identify remote files is not 
reconmended. | 

Indicates the. type of remote fite 
intercommuntcattion desired oy the 


application progran opening the file. 


CSee Pe Se 2219 O482» SMCS for an 
example.) 


The remote session number associated 
with the apptication program performing 
the open. It is *0000”" if there 1s no 
session assoctatione ol 


Contains the list of stations (by LSN) 


 tinceluded in the remote file. Each LSN 


occupies 3 characters in the List (See 
CURRENT.STATIONS above). 
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OPEN REVIEW CRITERIA 


When an open is approved without being sent to an MCS» ~ the 
network controller verifies thats; | 


There is room in the remote file table as indicated ody 


Ae 
the max files statement in the NOL dectaration section. 
Be Current.stations is tess than or equal to maxestattonss 
if not» it is set to maxestations.e 
Ce The fotlowing conditions are true: 
1. the station exists 
and 2e the adapter 1s present , 
and $- the station 1S appropriates i-ee@e» that 
| ae the otd primary is nutt 
| or be. the old primary does not have headers and the 
| secondary is null and the open.etype is output 
| | DO. the file is not a dummy file without headers. 
Before an open is forwarded to an MCS» the network controtter 


verifies that: 


There is room in the remote fite tabdle as indicated Dy 
the max files statement in the NDL dectaration section. 


Current.stations is fess than or equat to max-stationss 
if not» it is set to max-estations. 


The remote file being opened» if it is a dummy file» was 
Zzipmexecuted by a program with header se 


The following conditions are trues 


1. the station exists 
and 2- the adapter is present . 
and 3- the station is appropriates iteeer that 
ae the primary is null Cnot all stations) 
or db. the primary is the approving MCS 
or ce the primary does not have headers and the 
secondary is the approving MCS 
and 4-2 the nesting of open approvals and attaches 1s 
not too deep. 


old 
cn2) 
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Before an openereply is processed and approved for the user 
programs the network controtler verifies that: 


A. The open on this remote file was sent for open approval 
Be The MCS Set approve.deny to 71” tndicating approval 

C. Currentestations is less than or equal to max.stations 
De Headers and participating are not both set 

E. The following conditions are true: 


1. the station exists 
and 2- the adapter ts present 
and 3- the station iS appropriates i1.e6» that 
ae the old primary is null 
or be. the old primary is the approving MCS 
or ce the old primary does not have headers and 
the old secondary is the approving MCS 
and 4-6 the nesting of OPEN approvals and attaches 15 
not too deep 
and 5- aif participating» the primary is the approving MCS. 


The following tables summarize the action that the N.C. will 
take when it receives an OPEN or an OPEN.REPLY. 


aby ah Sa NG wa DT Nha ioe 


4-10 


BURROUGHS CORPURATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP MESSAGE CONTROL SYSTES INTERFACE 
SANTA BARBARA PLANT Pe Se 2212 5447 CF) 
JPEN 


§ ALL § SOME ORK ALL LSN*S 14 SOME OR 
P CSN*S | BELONG TO SAME CRF ft ALL LSN®*S 
f 


i 
{ 
AVATL [rete er reer sees ces een | BELUNG fT9 1 
i IRF = CRF ORF Z= CRF | OTHER RF : 
caw awn anwman | wanna [one e wa ewn | on meanness [eens es ane a | 
i ZIPPEO OR { | i i | ( 
4 EXEC BY | A .1 FCRE j DFL i NFL 1 
i NON MCS j { | i f 1 
eee et ee ee eee eee | a a = a (fe -- =< S<= [SS se= <<< i 
t ZIPPED 1 FMCS t=MCSIt /= 1 i i 
i BY j pecans] eer~] FMES i FMCS 1 
' 4CS j IFMCSIFCRE I { i 
OPEN. REPLY 
i ALL 1 SOME OK ALL LSN*S BELONG TO j 
§ LSN'S | A RF 4 
PE AVATL beret er st tr se ct ct ee eens ce en smc ane= | 
i i RF=CRF 4 RF /Z= CRF I RF /= CRF 3 
{ i 1 PRIMARY | PRIMARY 1 
i | ( EMPTY i NO { 
i | i i SEC=MCS i 
SN Se ee ee een en ee 8 eS ee a See seh a arn eae ca, ae a aw | 
FROM NON | i 
MCS | DFL i 
ae cteatetehateted Caketetatetebahettetekekateleleiete latent tatakatetatetatatetatetekatekeketetalt 
FROM j ICRF ICRF 1 | i DETACH 1 
MCS I A §= i v= 1 A { THEN { 
: IMCSIMCS 1 f A i 
j j=ee{==<e>{ { i 
j Atl C 4 i { 
LEGENDS 
A = send approve to MCP 
C - send close to MCS and deny open 


CRF = CONTROLLING REMOTE FILES If PRIMARY has HEADERS» 
then PRIMARY» else SECONDARY 

DFL - deny» fite locked 

FCREF -~ £=forward to CRF 

FMCS - forward to MCS 
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ATTACH MESSAGE 


The attach is @ mechanism whereby new stations are assigned to an 
existing remote filee Whereas the open message allows an initial 
assignment of stations to a new remote file» the attach protocol 
adds stations to the file sudsequent to the open. 


There are three important remote files Cnot necessarily unique) 
associated with an attach. 


le The attach initiator begins the attach process by writing 
an attach message. Eventually he wilt expect to receive 
an attachereply which watl either approve or deny the 
attach. The station list may be modified if the attach 
1s forwarded to another MCS for approval so it may _  ~0O5be 
necessary to review the station List in processing the 
completed attache | 


2- The attach object is the remote fite to which the 
stations are being attachede If the attach object is not 
the attach initiator» the open of the attach object must 
have been approved by the attach initiator. The attach 
object may or may not have headers. In either cases it 
receives no indication of the attach within the attach 
protocols» but may Decome aware of the attach via the 
inclusion of new stations in its normal message flows via 
aremote.fileeinfo» or via a user defined convention. In 
the case where this internal attach has been attempted» 
and the remote file for the MCS is full» an ATTACH-REPLY 
with DENY» MCSe-FULL will be forwarded to the attach 
inittator. 


3e The controlling remote file CCRF) of a station is the 
| file with headers to which the station was most recently 
attached Cor tnctuded in an open). If the primary has 
headers» it 31s the CRF>s otherwise» the secondary file is 
the CRF if one exists. | 


If the CRF of each station in the stationelist is the attach 
initiator or null» the attach is immediately processed and an 
attachereply sent back to the attach initiator. The signal 
character specified in the attach witt direct control messages to 
the attaching file for atl the stations he controls. 7 


[If the controlling remote file for the stations in the attach is 
a remote file other than the attach initiators the attach message 
is forwarded to the CRF and an attachereply 1s expected in 


responsee The CRF must approve or deny the attach and may modify 


the station tist of the attach. He atso specifies the signal 
character for ait stations he controts. This attach.ereply is 
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then reviewed by the NC» which either approves the entire attach 
and processes it or denies it. In either case» the attachereply 
is then sent on to the attach initiator. If another MCS approved 
the attach but the NC denied it» a detach is also sent to the CRF 
with attach.reply-in-error set to "1%. 


If a station is unattached» it may ve included in an attach. 
However » when the attach is processed by the NC» no secondary 
wiit be assigned. | 


If the stations in the station.etist have more than one CF» the 
attach wilt be denied by the network controtler. 


ATTACH TABLE 


Foilowing is a table indicating the status of a station before 
the issuance of an attach and after the receipt o f an 
attachereply. Participating or output~ontly stations are not 
included in the table because stations attached in those two 
classes do not change primary and secondary assignments. 


p = primary file 

S = secondary file 

seif = attach initiator (Cheaders) 

CRF = controlling remote file (not self) Cheaders) 

user = remote file whose open was approved by self (no headers) 


CURRENT STATUS | | ATTACH TO SELF ATTACH TO OTHER FILE 


status if approved status if approved 
unattached 
p=nulls s=null p=self» s=null p=others» s=null 
signalechar tgnored signalechar ignored 


attachereply from NC attachereptly from NC 


attached to self 
p=seif p=self -  pzothers s=self 
| Signalechar tgnored attach signal.char 
attach-erepty from NC attachereply from NC 


attached to CRF 
p=C RF | p=selfs» s=CRF p=others s=CRF 
attachereply sigechar attach.reply sigechar 
attachereply from CRF attachereply from CRF 


ERB AY be Aaa yo ahah Hatha uaa 
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attached to file without headers 


p=users s=null 


p=users s=self 


p=users s=CRF 


MESSAGE-TYPE 
USEReREMCTE-FILE.NO 


attach denied by NC 
p=users» s=nultl 
attachereply from NC 


p=users» s=self 
signai.echar itgnored 
attachereply from NC 


p=self» s=CRF 
attachereply sigechar 
attachereply from CRF 


Table 4.2 ATTACH 


*-+- = 
ee eDOE 


ATTACHING-RENOTE-FILE-NO 


SIGNAL.«CHAR 
APPROVE .CENY 
DENIAL.REASON 
PROGRAM.JOB.NO 
ATTACH.TIME 
CURRENT.STATIONS 
ATTACH.COUNT 
FILLER 
LSNeLIST. 


MCS ~ attach initiator 


* 
* 


CRF - controlling remote file 
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attach denied by NC 
p=users s=null 
attach.ereply from NC 


p=others» s=sel f 
attach signati.char 
attachereply from NC 


o-others s=self 
attachereply sigechar 
attachereply from CRF 


NC“CRFE 


W 


R PIC 


"3 
* 999 
& 


9€7) 
9€7) 
999 
999 
XC 3) 
C999) 4 


* et & 


* 
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Table 423 ATTACH.REPLY 


MESSAGE.TYPE 
USEReREMOTE-FILE-NO 
ATTACHING.REMOTE -FILE.NO 
SIGNAL.CHAR 
APPROVE.CENY 
DENIAL-REASON 
PROGRAM.JOB.NO 
ATTACH.TIME 
CURRENT.STATIONS 
ATT ACH.COUNT 

FILLER 

LSN.LIST 


The semantics of the 


CRFO-NG NC“MCS 
W RW R PIC 
+ * * & 99 
* % 999 
* x & 999 
te & te X 
+ & * * 9 
fk & 9 
ts * 9€7) 
* * 9€7) 
* * fe 999 
x fe 999 
~XC3) 
& & C999)4 


fietds in the attach and attach-reply 
messages are similar to the open with the following excertions: 


ATTACHING-REMOTE.FILE-.NO The fite number of the MCS originating 


SIGNAL .CHAR 


DENTIAL.REASON 


the 
by 


attach or attach.reply. it 1s set 
the network controller before 


forwarding the message to another MCS. 


Set by the controiting remote fite. It 
is used by the network controtler to 


identify messages intended for the 
secondary file of a station. 3lank 
implies no Signai character. For 
previously unattached stations and 
stations whose CRF is attaching to 
himself» the signal character is 
ignored. 

Set by the network controtler when an 


attach is denied. It may have the 
fotlowing vatues: | | | 


ae 6 ais 
ha hdd 
a7” 
sai, ie 
war 
we 
ie” da 


a o Hin 


“gt 


- MCS full 
- invatid remote file 
- file tocked 


- adapter missing 


- CRF denied the attach 
- (not used) 
- invatid LSN in List 


- too many MCS*s for one of the stations | 


{the nesting of the opens and attaches 
is too deep) 

- attachereply error 

- too many stations in fite 


BURROUGHS CORPURATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


PRUGRAM.JOB~-NO 


ATTACH.CNT 


ke15 


COMPANY CONFIDENTIAL 
MESSAGE CUNTRUL SYSTEM INTERFACE 
Pe Se 2212 S447 CE) 


On an attach is the jod number of the 
owner of the attaching remote file. On 
an attacherecly this will be the jon 
nueber of the controlling remote file. 
If this fietd corresponds to ones own 
file upon receiving an attachereply» the 
attach was approved by the network 
controitier ontye 


The field reflects the actual numbder of 
LSNs that exist in the REMOTE_FILE. 
This number is used to determine’ the 
number of stations actually attached. 
Due to the PASS mechanism» LSNS are 
never removed from a remote file» even 

if a station is detached. Thus» while 
the MCS may attempt to attach 5 
Stations» only 3 new LSNs may be added 
to the remote file. Because of this» 
the field is used ay the MCS to set 
REMOTE_FILE_CURRENT_STATIUNS» which 15 
set only upon receiving the 
ATTACH.-REPLY. | 


Before an attach is approved without being sent to another MCS» 
the network controtter verifies that: 


Ae The remote file exists Cuser-eremote.-fileeno is valid) 


Be The attach initiator approved the open of the remote file 
or the attach initiator is the user remote file 


C. Currentestations 


+ the stations already attached to the 


file is less than or equat to saxestations for that fite 


De The foilowing conditions are trues 


le the station exists 
and 2- the adapter 1S present 
and 3- the station iS appropriates teeer that 


ae the 

or be the 
or Ce the 
the 


otd primary is null 

old primary is the attach initiator 
old primary does not have headers and 
old secondary is the attach initiator 


and 4. the nesting of open approvals and attaches is 


: . not too deep | 
] and 5. if the file is indicated as participating» the 
i 7 | primary is the attach initiator 
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before an attach is sent on to the controlling remote file (not 
the attach initiator) for approvat» the network controller 
verifies that: | | 


Ae The remote file exists Cusereremoteefilesno is valid) 


Be The attach tnittator approved the open of the remote file 
or the attach initiator is the user remote file 


Ce Currentestations + the stations atready attached to the 
file is tess than or equat to max.estations for that file 


De The fotlowing conditions are true: 


ie the station exists 
and 2e the adapter is present 
and 5-2 the station is appropriates t-.e€e» that 


ae the old primary is null Cnot all stations) 

or be. the old primary is the controitling remote file 
or ce the otd primary does not have headers and the 
old secondary is the controtling remote file 


and 4 the nesting of open approvals and attaches is 
not too deep | 


Before an attachereply is processed and approved for the attach 
initiator» the network controller verifies that: 


A- The remote file exists Cuser.remoteefile-no is valid) 
6 The attach was forwarded to the CRF for approval 
Ce. The CRF set approveedeny to "1" indicating approval 


De Current.stations + the stations already attached to the 
file is tess than or equal to maxestations for that file 


EF. The following conditions are true: 


1. the stations exist 
and 2- the adapter 1s present 
and 3-e the station iS appropriates ieee» that 


ae the old primary is null 

or b.- the old primary is the controtling remote file 
or ce the old primary does not have headers and the 
 otd secondary is the controtling remote file 


and 4 the nesting of open approvats and attaches 
is not too deep 


FU TERY Lat Be nate bees aay Seas sr ote eecky Pee oe Se ox - RO ee ee pC Ne CES TRL RS, Me DSS ROR Se ane Soe LIES a OM Seem BRIT far oC. tor SPH atin ly AEN Pie SO Ra tr ge pa PPE aang iy IE, Bae aD i 7 -rigtehas. kh el 
RC Sac oer AANA Teen ART ER IA ad Mee CE RR Re Me ECL en CMA C LO ECE, LA OME ER Eee ree ne em 
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DETACH MESSAGE 


The detach is related to the ciose in the same way that attach is 
related to the open message. It ts provided for negating the 
effect of an attach» removing stations from the station list of a 


wemote file and returning them to their previous ownerse 


If the user-eremote.fileeno is valid» the detach wilt be 
processed» station by = stations according to the fcllowtng 
criterias 


le. A file may detach a station from itsel f. If there is a 
file which approved the open of that file» it is notified 
via the detach message forwarded by the network 


controiler. This indicates to the receiving file that it 
is now the primary file again. | 


Ze A fite may detach a station from a fite whose attach or 
open it approved. 


3e When a station is detached from the remote file 
specified» it is atso detached from all files to which it 
had subsequentiy become attached. 


4. When an attachereply has an errors a detach message 15 
sent to the CRF with the attachereply-.ineerror field set. 


This attlows for three different detach messages: 


1. Wessages sent by a remote file with headers to detach a 
Station from its file or a directly subordinate’ fite. 
These detach messages will be responded to with a 
detacherepty from the network controller» the LSN list 
indicating stations actualty detached. 


Ze Messages sent by the network controlter to notify an MCS 
that it now controts a list of stationse No detachereply 
is necessary. 


Ze Messages sent by the network controller to notify a CRF 
writing an attach-ereply that the attacherepty had an 
error and the attach did not get processed. No 
detachereply is necessary. 
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An MCS may request that the LSN of a station being detached de 


removed from the FISB of the remote file. This action» which 
clears the LSN for the FI8*s station table» is called the CLEAR 
optione It permits comaunication with any number of stations 


Cnot to exceed FIBe-REAL-MAX stations at any given time) instead 
of timiting communication to the first stations that sign on or 
pass tnput to a programs. As a result of this options once a 
Station is detached» messages cannot be written to that station. 


Some progrags using the CLEAR option are subject to unexpected 
resutts. Programs that do not contain ON EGF branches for their 
remote file write statements ares upon attempting to writes 
detached by the MCP with an invalid key messages» Also» programs 
using retative keys may incur a Situation where the message 15 
sent to the wrong LSN. For example» if station A signs on to 
program X which employs relative keys in its remote file reads 
and writes» the MCS fires up program X and piaces station A's LSN 
into the FIB. Consequently» whenever program X writes a response 
to KSN il» the traffic is sent to station A. A problem occurs 
when a particular input request requires lengthy processing time 
betore program X returns a response. If station A signs off 
prior to receiving the response» that response could erroneously 
be directed to the wrong LSNew When the ACS issues the DETACH and 
CLEAR» the LSN is removed from the FIB. if station B signs on to 


program X before the response is ready» it will receive the 
message intended for station A. If program X sends the response 
after station A signs off and before station 8B signs. ons an 
invalid key exception wilt occur. A simple detach witt deliver 


the response to station A when the user signs on again. 


The following 1s the format of the detach message: 


Table 42.4 DETACH/DETACH.REPLY 


MCS“NC IC“MCS 
- W R W R PIC 

HESSAGE.TYPE + & * * 99 
USER. REMOTE.FILE.NO + & * * 999 
ATTACH. REPLY IN ERROR * * 9 

- CURRENT.STATIONS + * t t 999 
DETACH. AND.CLEAR a * * 9 
FILLER © | XC5) 
LSN.LIST | + t * & C999)4 


The semantics of the fields of the detach and detach-reply 


messages are the same as fields in the UPEN message with the 


exception: 
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ATTACH.REPLY-INe ERROR A bootean which» when set to “1"» 
indicates that the attachereply was in 
error. 

DETACHeAND.CLEAR A boolean which indicates to the NC and 
MCP the need to remove the LSN from the 
FIS. 


CLOSE HESSAGE 


The close message is provided as a negation to the open message. 
Close messages originate from the operating system and are passed 


to the remote file which approved the file open. Also» a close 
may be initiated by the network controller if an openereply 
approving an open was in error (see UPEN). The close message 


requires no reply. 


if an MCS closes its files the files whose opens it approved witt 
also be closed. They will receive no new messages. An 
end~of-file message is queued after the last currently "queued 
messagee The stations are relegated to the primary/secondary 
configuration which existed before the closed file was opened. 
The one exception to the above rute is when an CS participates 
in user prograa I/0» a close on the remote file does not alter 
the primary and secondary files for the station. 


Following is the format for the close message: 


Table 4.5 CLOSE 


NC-MCS 

W R PIC 
MESSAGE.TYPE * te 99 
CLUSE TIME * * 9€7) 
PROGRAM.JOB.NO | * te 9(7) 
USER-REMOTE.FILE-NO * * 999 
UPENeERROR % * 9 
CURRENT.STATIONS % * | 999 
FILLER X (6) 
LSNeLIST * * C999)8 


The semantics of the fields in the close message are similar to 
the open message with the exception: 


OGPEN-ERRGR A boolean set bDy the network controller 
to indicate that an MCS open approval 
was invalid. 
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STATUS MESSAGE 


Status aS now onty applicable tc stations. The format of the 
Station status/statusereply message is as foltows: 


Table 4.6 STATION STATUS REQUEST/REPLY 


MCS“NC NC“MCS 
: W x W R PIC 

MESSAGE.TYPE + ad * * 99 
LSN + tr a 999 
REQUESTING LSN * * 999 
STATUS-ERROR = = * * 3 
STATLON.NAME - « X(10) 
STATIGN.READY | 7 - = t * 9 
STATION ENABLED | = * & k te 9 
STATION.MYUSE = ! = = * * 9 
STATICNe TERMINAL TYPE ? * * * 99 
STATION. BUFFERS IZE = = * * 9€5) 
STATION.TRAN.NOG-SIZE = = * * 9 
STATION. TRAN.RECEIVE - - - XXX 

— STATIONS TRAN.TRANSMIT = 7 te * XXX 
STATION. RECEIVE.ADOR-SIZE im - * * 99 
STATION. TRANSMIT -ADDR~SIZE = = & * 99 
STATLON.ADOR.~TRANSMIT 7 = - * * X€20) 
STATIGN.MAX.RETRIES - = * * 999 
STATION-PRIORITY RECEIVE = = * t 999 
STATIONePRIORITY.TRANSMIT = = *% * 999 
MESSAGE COUNT = = * * 9€4) 
DIAGNOSTIC.REQ.ON - = ‘+ & 9 
LOGICALACK.ON | 5 = * * yg 
GOOD.~RESULTS.ON | = = * * 9 
STATION. TALLIES — aa sa * & 9(9) 
 STATION.TOGGLES , = = * * 9€8) 
STATION REMOTE.F ILE | = aot * & 999 
REMOTE.FILEsHASeHEADERS | - = s + 9 
STATICN.PHONE : = - * % X€20) 
STATION.VALID | = * * te 9 
STATION. LINE.NG aes iy & * 99 
STATION.~SECONDARY.FILE.NO = = * * 999 
FILLER | XC10) 
LINE.COUNT | = = * * 99 
LINE. INFO = = * t C999)# 

LINE # 99 


ACU 9 


It is noted that only messageetype and LSN fields are required 
for a vatid status message. 


BURROUGHS CORPORATION 
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LSN 
REQUESTINGsLSN 


STATUSeERROR 


STATION.NAME 


STATION. TALLIES 
STATION. TOGGLES 
STATION REMOTE.F ILE 


REMOTEFILE. HAS. HEADERS 


STATLON« PHONE 


STATLIONeLINE.NO 
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The semantics of the status message fields are as follows? 


The Logical station number of the 
stations the status o f which is 
requested/provided. 


Providec for designating the station 
requesting the information. Tt 1S not 
required to be valid. | 


Returned from the network controller and 
is "1" except when the LSN provided in 
the status request was tnvalids ir which 
case it is "GO". 


Through diaaenosticereqeon provides’ the 
sane information as the station status 
rep«y message of previous releases» Dut 
in wharacter format. 


Provides talttes 0-2 and toggles 077 in 
the same format as the data message. 


Indicates the number of the remote file 
to which normat input is attached. 


Indicates whether the above remote file. 
was opened by an MCS~-type progran. 


The current phone nugber assigned to 


this station. Phone numbers are treated 
the same as with the NOL compiter. any 
tnvalid digit in the string is reptaced 
by the pause character (CFF hex). 


The current line assignment for the 
station. 


OTATIONeSECONDARY.~FILE-NO The remote fite number of the station's 


LINE.jCOUNT 


LINE.INFO 


secondar ye If it is "000"%» then there 
1s no secondary. 


The number of tines on which the station 
is definede 


Lineecount 3scharacter fields describing 
the tine number (Cchar 2) and its 
associated dialout status boolean (char 
1). | 


A program with remote file headers may send a status message and 


recetve a corresponding status reply. 
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CHANGE MESSAGE 


The only parameters subject to change are station change 
parameters. Line attributes are opaque to an MCS. 


The format of the change and changeerepiy is as foilows: 
As of 8-0» an MCS may no longer issue a CHANGE message affecting 


STATIGN.-ENABLED. This flag is uted tnternally oy the NC for 
queue manageasente | ; 7 


Table 4.7 CHANGE/CHANGE.REPLY 


MCS-“NC NC-MCS PIC 
MESSAGE.TYPE + te & # 99 
LSN + & ra 999 
REQUESTING.LSN * t XXX 
CHANGE.TYPE 4 & te 99 
CHANGE.RESULT | * * 9 
CHANGE VALUE + te & X€20) of 
XXX or 
999 or 
 X or 9 


(See chart below.) 


The semantics of the change message are as follows: 


iLSN The station whose parameter 1s to De 
| : changed. : 
REGUESTINGsLSN | An optional field provided for the LSN 


of the station dtrecting the change. 
This field is not used by the network 
controller and can contain information 
In any format desired. 


CHANGE.TYPE Indicates the fietd to be changed. The 
meanings ares 


CHANGE TYPE FIELD VALUE FURMAT 


"00". TRANCRECEIVE ) XXX 
"01" TRANC TRANSMIT) XXX 
"Q2"  ADDRESSCRECEIVE) X(20) 
"03" ADDRESSC TRANSMIT) X€20) 
"04" | FREQUENCY CRECEIVE) 999 
"05" FREGUENCYC TRANSMIT) 999 
"06" MAXeRETRY 999 


"08" = = READY | 9 
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"Q9" DiAGNOSTIC.ON 9 
“10" | LOGICALACK. UN 9 
"11" — GUGORESULTS.ON 9 
mie STATION.~j PHONE X€20) 
"15" SIGNAL. CHARACTER x 
CHANGE-RESULT Returns "1" unless there was an error in 
the message. “O"* implies an invatid 
LSN. "Oo" tmplies an invalid change 
typee 
CHANGE.VALUE The field's new value in left-justified 


character formate 


REMOVE MESSAGE 


The recatt message is provided for removing any nuader of 
messages from the top of a station's output queue» marking thea 
as recalledemessages» and sending then» orefixed by a 
recail.reply message» to the MCS. The recali.reply contains the 
number of messages to foltow. 


The remove message is provided for removing any number. of 
messages from the top of a station"*s queue. The network 
controlter witl always respond with a removeereply indicating the 
number of messages actually removed. 


A cautionary note: when using recall and remove» it is best to 
make the station not ready first as otherwise the first message 
may or say not be included» depending on whether the statton 15s 
currentty Deing processed. 

Recalts» recatt-.repl y» remove and removeereply messages are 
formatted as follows: | | 


Table 428 RECALL/RECALL.REPLY 


MCS“NC NC“MCS 


| W R | W R PIC 
MESSAGE.TYPE i + * x * 99 
LSN + te te 999 
REQUESTIANG.LSN * t 999 
MESSAGE.COUNT | + * te x 9¢€ 4) 
RECALL-ERROR | t & J 
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The semantics of the RECALL fcrmat are as follows: 


LSN | The station from whose sutouk queue the 
messages are to be recalled or removed. 


REQUESTING.LSN This fieid indicates the Station 
initiating the recail or remove. 


MESSAGE.COUNT  Ortginatly the number of messages t. de 
| recalled/ removed ("001" for one» *999"% 
for ail) and in the repty» the number of 

messages actually recatled/removed. 


RECALL-ERROR © set to "1" if the message is improperly 
foraulated. 


A recatl witl place the recaltled.messages immediately following 
the recall.reply. 


RENOTE-FILE- INFO MESSAGE 
An MCS~type program may control a set of stations by opening a 
remote file with the header option. In order to provide 
necessary information about the file just acquired» the 
resote-file.info/remote-file-info-ereply protocol is provided. 
The format is as follows: 


Table 4.10 REMOTE.FILE. INFO/REPLY 


MCS“NC NC- _ 

W R W PIC 
MESSAGE.TYPE + te _’ * 99 
JOB—eNO t * 9(7) 
TIME a te * 9(7) 
REMOTE.FILE.NO #(*«) «& * 999 
UUTPUT -MESSAGES~QUEVEC : & * 9(4) 
INPUT.MESSAGES.QUEUED te * 9( 4) 
CURREANT.STATIONS , t * 999 
UTHER.RF -REQUEST tk te 9 
UTHER-RFeERRGR * * 9 
OPEN-APPROVER.RF.NO % * 99 
FILLER | | | | 99 
LSN.LIST | * * C999)# 
OUTPUT.QUEUEO.LIST | * * (999)¢@ 


(#) Mandatory only if OTHER-RFeREQUEST is "1". 


it is noted that only messageetype is required for a valid 
remote-efile-info inquiry on the file originating the inquiry. 


hy Spall yeahs ATA URGE. oh” Lay lee ad es Aly Suvoit vitae TPE ani oe 
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The semantics of the remaining fields are as follows: 


JOB.NG JobdD~number of the MCS~-type file. 

TIME The time that the reply was sent. 

REMOTE.~FILE.NO The number of your remote file =if 
other.rferequest is 70". It 1s the 


number cf the target remote file if 
other.rf.request ts "1". 


GCUTPUT.MESSAGES.WUEUED The total of alt messages queued for 
| output to alt Stations in the file. 


INPUTeMESSAGESe QUEUVED The total of alt messages queued from 
alt stations that are destined to De 
read by your file. 


CUNRRENT-.STATIONS The number of stations attached to the 
file. 
UTHER RF REQUEST "Oo" af the recuest is for the writing 


MCS*s fitee It is "1" tf remote.-fileeno 
contains the file number about which 
information ts requested. 


UTHER.RF -ERRUR "1" in the repty is the requestor had 
| set othererferequest to "1" =and the 
remoteefite.no supplied was 


nonmexistente. 


UPEN-APPROVER.RF .NO The remote file nusoer of the MCS) which 
| approved the requestor'’s open. 
LSN.LIST le Has an LSN for every current station. 
GUTPUT.QUEUED-LIST Has the output messages for each of the 
Current stationse It shoutd total to 


outputemessages.queuede 


The CLINE.RELEASE message atilows a user to request» through an 
MCS» that a line Cdesignated by a port» channel » and adapter 
triplet) be released from ownership by the network controller. 
For instances when a network controller initializes a multiline, 
ali fifteen adapters are tested for the existance of an Auto~call 
unit CACU). Since the ACP associates I/0 ops with the progran 
issuing thems the network ccntroller is considered the “owner” of 


ail fifteen adapters. The user may decide to use one of these 
adapters for another programs such as RJE» HASP» or a second 
network controlter. In order for the MCP to allow this» the 


Lines that are not active aust first be released from ownership 
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of the first network controller via the LINE~RELEASE message. 
A line is released when the following conditions are mete. 

1. The NC owns the Line 

Ze The Line status 15s 


de idle or no wessages are queued for a station on 
the line. 


De and no station on the tine 15 enabled 
36 If a multiline exists and the request is for a tine 
with an ACU (Cthe status of the ACU must not he 


"in“use™)e 


The format for LINE-RELEASE and LINE.RELEASEsREPLY is: 


Tabte 4.9 LINE-RELEASE/LINE.RELEASE~REPLY MESSAGE FURMAT 


NC“MCS MCS“NC 

| WOR WOR PIC 
HESSAGE*TYPE * * + & 99 
REL «PORT»NUMBER * + * 9 
REL «CHANNEL .NUMBER * + * 99 
REL» ADAPTERsNUMBER tk + * 99 
REL «RESULT *  & x 


The semantics invotved in the message format are: 


HESSAGE.TYPE "30" - LINE.~RELEASE 
: wZL" - LINE.~RELEAScC.REPLY 
REL eCHANNEL.NUMBER © The triplet that describes the line to 
REL ACAPTER-NUMBER be released. — 
REL eRESULT "oO" = tine released 


"1" = not released» NC not owner of line 
"2" - invalid parameters | 
"3" - not retleaed» NC using line 
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Additional controt messages have been aade avaitable to implement 
ANSI COBSOL74 within the 31800/81700 datacomm framework. These 
messages only pertain to an MCS interacting within a C039L74 
environment. Further reference should be made to the facilities 


described in the Communications Module section of the COSOL74 


product specifications PeSe ###k #HEHS 


Tables 5.1 and 5.2 tist the messages and their types. 


Tabte Sel MESSAGES READ 


MESSAGE TYPE 
C74-CLOSE 16 
C74-0PEN 18 
C74e-CREATE. QUEUE 34 
C74-ENABLE.OISABLE 36 


C74.CELETE. QUEUE 38 
Table 5.2 MESSAGES WRITTEN 


MESSAGE a | TYPE 


C74.0PEN-REPLY 19 

C74-CREATE.QUEUE-REPLY | 35 

C74eENABLE.~DISABLE.REPLY 37 

C74.-DELE TE-QUEUE-REPLY 39 

C74 CLOSE 
When a CCBUL74 program executes a DISABLE INPUT statement>s or 
goes to EOJ» the CP generates a normal CLOSE message 
CMESSAGE.TYPE = "16"). If it is the OPEN.APPROVERs the NC passes 
this message to an 4ACS. it is then necessary for the MCS to 


examine the PROGRAM.JOB.NO to determine if the message was 
created by CUBOL74. _ oa 7 


Table 5.3 lists the format for the CLOSE message- 
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Table 5.3 C74 CLOSE FORMAT 


NC“4CS 
W RR PIC 

MHESSAGE.TYPE * * 99 
CLOSE.TIME * 9(7) 
PROGRAM.JO8.NO * i 9(7) 
USER.» CUEUE.NO . * 999 
UPENS ERROR * g 
CURRENT-STATIONS * * 999 
COBOL 74.F INAL * * 9 

FILLER X(5) 
LSN.LIST - (999)# 


The semantics of the fields ina C74-CLUSE are the same as a 
normal close except that COBUL74.FINAL is set to 1 Dy the MCP if 
the CLOSE applied to the tast ClUrul74 jod using VF ReGQUEUL. 10e 
and if USER-QUEUE.-NO wasn't created oy the MCS. : 


C74 GPEN 


This message is issued to the NC by the MCP whenever one of two 
conditions is caused oy the Cus80L74 program: one is the 
execution of a RECEIVE statement for a queue not previously 
accessed by the programs» and the other ts the processing of an 
ENABLE INPUT <queue id>-« In each case» access to an information 
path must be granted and the information path must Ode 
established. (The queue may exist alreadys see 
C74-CREATE QUEUE.) 


The NC treats this message as an OPEN request. If an MCS is 
presents C74.-0PEN is forwarded to it for approval. The reply 
from the MCS is sent back to the NC and the WC relays the message 
to the MCP via a DO_WRITE communtcate. Upon reinstatement» the 
COBOL74 program examines the status key to check the outcome. 


COBOL74 datacommunications makes provisions for the use of 
passwordse lf the boolean PASSWORD.-USED its set» the MCS verifies 
the validity of the fietd PASSWORD» and if the field is invalid» 
C74-0PEN is denied. If the boolean is not set» no action is 
required of the MCS concerning passwords. 


The NC altows a C74-0UPEN only if SIMPLE-HEADER-UPTION and 
HEADER-OPTION are set and if REMOTE.KEY is not sete 
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PARTICIPATING 


COBWOL74 data cowmunications input queu2 opens may be approved 
“participating™ by an MCS. In this case» data input from 
Stations to these queues wilt be routed Coy the network 
controlter) to the MCS that approved the open. Data output by a 
COBOL74 SEND to stations witl be routed Cby the SMCP) to the MCS 
that approved any open for the COBOL74 progran. Thus» 
participation on output messages will happen onty after a queue 
open tS approved by the HCS. Participation on output messages is 
on a program basis rather than on a queue (file) basis because 
SENDS refer only to a station .terminal or SYMBOLIC DESTINATION)» 
rather than to a queue or file. Thus» if any input queue’ open 
for a CQBOL74 program (Csuch as one of @a::y) 3S approvea 
participating» alt SEND output by that program witt de 
participating and witlt be sent to the MCS that first approved the 
open “participating” instead of being sent directly to the 
statione 


Table 5.4 tists the format for the C980L74 open and reply. 
Following the table is a list of fields that differ from a normal 
remote file open. | 
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Table 52-4 C74-0PEN/C74.0PENJKEPLY FORMATS 


NC“MCS MCS-NC 
R WOR PIC 
MESSAGE.TYPE * & + * | 99 
UPEN.TYPE * _ ft | | 9 
OPEN. TIME t te 9€7) 
PARENT.JOB NO & * : 9073 
PRUGKAM.JO8.NG & #8 907) 
PROGRAM.»NAME 7 XC 30) 
HEADER-OPTIGN * & 9 
SIMPLE.HEADERSOPTION i % 9 
KEMOTE.KEY 9 
RESTOENT Si ts * * 9 
USER. CUEVE.NU te t t 999 
SIGNAL.CHAR * * X 
APPRUV-DENY + te 9 
WENY.REASON 4 & 9 
PANTICIPATING * * 9 
GOOQD.RESULTS * * 9 
MAX-STATIONS * * 999 
CURRENT.~STATIONS * * * x 999 
LIST.TYPE * * 9 
FILENAME * * X€190) 
KEMAINDER.SOQN * & X¥C€38) 
PROTUCOL.TYPE te * 99 
SESSION * t 9(4) 
PASSWORD * * X€10) 
PASSWORD.USEC te t 9 
INPUT.G.RECORD.SIZE * * * * 904) 
INPUT.Q. BUFFERS te * t ke 9(4) 
INPUT.Q.2CEPTH t t * 904) 
FILLER X€10) 
STATION.LIST & & te & C999) # 
MESSAGE.TYPE C74.0PEN = "16%» C74.0PEN-REPLY = "19" 
 PRUGRAM.JOB.NO and Wiil always contain the vatues 
PROGRAM. NAME associated with the COBUL74 program 
| originating the run unite Thus» if the 
program for which this C74.-GPEN has been 
1ssued was "CALLEG%» its job number and 
name will not be given. 
KEMAINDER.SQN For 9.0 must be set to att blanks. The 
| SQN resides within FILE.~NAME. 
APPROVE.CENY © Set in the C74 .ENABLE.DISAULE-REPLY ody 


the MCS: 


= "1" if approved. 
= "O" af request is denied. 
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DENTAL.~REASON Set in the C74.ENABLE.~DISABLE.REPLY» are 

valid onty if APPROVE.DENY = "G6". I f 


equal to "1" then the status key tn the 
COB8OL74 program will reflect an INVALIU 
DESTINATIUN. It equal to any value 
other than a “1"%» then the status key 
Wild be set to INVALID PASSWORD. 


PASSWORD 1) if an “ENASLE INPUT <queue"name>" 

PASSWORCT.USEL caused C74.UPEN to be generateds 

: PASSWURD is requi¢ced and PASSWOKD.USED = 
W116 


2) If a "RECEIVE" <queue"name> statement 
was executed by a CUBDL74 progran» the 
C74.0PEN generated by the MCP will 
have PASSWUGRC set to att blanks and 
PASSWURD.USZED witl equal "0". 


INPUT .@C.RECORC.SIZE Default vatue Cequals maximum buffer 
size for any terminal on the line) is 
set by the WNC. The 4CS can alter the 
value in the reply. 


INPUT.Q.6UFFERS Default (2 buffers) is set by the NC 
| before it forwards message to MCS. The 
later can alter the value tn the reply. 


INPUT.Q@-DEPTH Set by NC and atiterable by the MCS. 
Default is 10. 


This message» issued only by an ACS» causes the explicit creation 
of a COBOL queue. There are two intended uses for this message» 
one is for apptications employing transaction"based routing 
CTBRI» and the other is for situattons in which the MCS ts aware 
of the future requirements for a specific queue or set of queues 
and can create them before they are actually needed. The reply 
from the NC indicates the remote file nusder of the queue just 
created. When the MCS schedules a COBOL74 job that with use a 
previously created queues the syntax for symbolic queue name 
(SQN) is used. 


An important difference exists between the C/74-0PEN and the 
C74-CREATE-QUEVUE requests. The creation of a queue via a 
C74eCREATE-QUEUE request does not give a COBOL74 program 
automatic access to ite Moreover» a queue created explicitly Dy 
an MCS is not removed because there are no COBUL74 programs using 
it for data transfer. The queue 15 not closed until either the 
MCS goes to EGJ» or until the MCS issues an explicit close. 
However» the queues built as a result of a C74-UPEN requests» are 
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destroyed when the last program raving access to it goes to EJ. 


The MCS ts considerably flexible tn managing queues. 1 f » for 
exasples the MCS receives an OPEN request that was generated tn 
response to a C74.OPEN for a currentiy nonexistent queues it has 
two possible options (pending approval of the UPEN): one option 
is to issue the OPEN_REPLY and cause the creation of the queue 
which wilt grant access to the queues or alternatively» the MCS 
can issue a C74-CREATE-QUEUE>» wait for the 
C74-CREATE-QUEUE-REPLY» and return tie OPEN_REPLY» thus retaining 
control over the queue. 


The format for the C74-CREATE~-QUEVE and C74.-CREATE.-QUEUE.REPLY is 


the same as the C74.O0PEN except for the following fields. 


MESSAGE.TYPE C74-CKREATEeQUEUC = "34" 
C74.CREATE-QUEULeREPLY = "35" 

TINPUT.~QeRECORD.SIZE If not set initially Cthat is» ="0900") 
by the MCS» the NC defaults the vaiue to 
"2000". 

INPUT .Q.6UFFERS Same default as for C74. 


C74 ENABLE: DISABLE 


CUBUL/74 programs execute ENABLE/DISABLE statements to modify the 
logical connectivity between sources and destinations and_ the 


associated queues. There are two possidle input formats and one 
output format. For input» either the TERMINAL or <INPUT 
<queue~itd> form ts used. With the TERMINAL forme» message 


transfer from that station is atlowed or disatlowed accordingly. 
With INPUT <queue"id>» the connection path is established/broken 
and an OPEN/CLOSE is appropriately issued by the MCP tao the WNC. 
For outputs onty the TERMINAL form its used. 


ENABLE/CISABLE requests are forwarded to the NC Sy the MCP. If 
an MCS is presents the NC passes the request and waits for a 
reply. Requests of this type may not be generated by the MCS. 


If the request is logically valid and an MCS is not involved» it 


will be granted. To be togicaity valid» the STATION.NAME must 
exist within the datacomm network» and the station must already 
be attached to a COBOL74 queue. 


The password option 15s an additional interaction that occurs 
between the ENABLE/DISABLE requests and the MCS. The 
adatnistration of this option is the responsibility of the MCS. 
Within the message is a 10“byte field which contains a character 
string. | 


Table 55 tists the format of the C74.ENABLE -DISASLE request and 
is followed by a description of the various fields. 
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Table 565 C74 ENABLE-DISABLE/C74. ENABLE DISABLE «REPLY FORMATS 


HESSAGE.TYPE & & + * 99 
STATZIONSLSN © * * * 999 
STATION. NAME * * * XC12) 
APPRUVE.DENY + 9 
DENTAL.REASON + * 9 
FILLER 9 
PASSWORD t * XC19) 
PROGRAM.JO8.NO * * * 9€7) 
ENABLE.DISABLE & * * 9 

USE * & & 9 


The meanings of the various fields are: 


MESSAGE.TYPE C74- ENABLE DISABLE = "367 
| C74-ENABLE.DISABLE.REPLY = "37" 

STATION.LSN «Tf not equal to "000" then the LSN of 
Staticn affected. 

STATICN.~NAME | Identifier uniquely representing this 
station within the NC. 

APPROVE.CENY Set in the C74.-ENABLE.~DISABLE.REPLY by 
the MCS: 


"1" If approved. 
"O" wf request is denied. 


DENTAL.REASON Set tn the C74.-ENABLE.DISABLE.REPLY>» are 
valid only if APPROVE.DENY = "Oo". If 
equal to "1" then the status key in the. 
CGOBOL74 program witl reflect an INVALID 
DESTINATION. If equat to any vatue 
other than a “i"» then the status’ key 

 wiil be set to INVALID PASSWORD. 


PASSWORD 3 Character string sent from program to 
| MCS via MCP and WNC to be used (for 
password validation. 


PROGRAM.JOB.NO | The job number of the COBOL74 program 
: | which originated the run unit Cnot 
necessarily that issuing the request). 


ENABLE.CISABLE = "1" if an ENABLE request. 
= "0" af a DISASLE request. 
USE I/CG mode: 


"i" if INPUT. 
= "0" if OUTPUT. 


Seti ies hake Wis AY ci Stiuiat ok Sante aa TRAC Te AT ay SE Ta ga Hela Bu aTY Sibir) 
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«G14 BELEIE Queue 
The C74 Delete Queue is used to femove a queue that was created 


Via a C74sCREATE QUEUE. Onty an MCS may issue such ai request. 
The format is described in table 5.6. 


Table 5.66 C74.0ELETEsGUEUE.FURMAT 


MCS-NC 

W R PIC 
MESSAGE sTYPE + 99 
USERS QUEUE .ND + t 999 
MESSAGE.TYPE = "38" 


G74 DELETE QUEUE REPLY 


The C74 Delete Queue Rept: that is returned to the MCS from the 
NC has the same format as a C74&CLUSE with the following 
meanings: 


MESSAGE.TYPE = "39" 


*ROGRAM.JOBeNO | Set to the job  mumber of the CO39L74 
program originating the run unite 


USER.» QUEUE.NU | Same as USEReREMOTE.FILE«NO in a normal 
CLOSE message. 


OPENeERRGR | Set by NC to incicate action taken in 
response to request: 


"1" aif no errors; cueue removed. 

"O" af USER-QUEUFE.ND stiil in uses it 
be removed when released. Please notee 
however» that the MCS no longer has 

any control over the queue. 
= "2" af USER.-QUEU=.NO was invalid. 
= "3" af the USERSQUEVE.NG specified in 
request does not telong to the MCS. 


COWOL74.F INAL | Set by the NC to indicate whether there 
are any more CUBGL74 programs using 
USEK-QUEUE.NO. 


= "1" if no more programs. 


wilt 
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DATA MESSAGES 


To facilitate CUHOLP Os 4 Hew data message type fas been created» 
in addition to the normal message. | ‘ | . 


TYPE = "Qgae 


This (9 @ fagul at data message ekcept Fot the mestdge type which 
equals "Oa". An MCS which owns atations accessed CoFf to be 
accessed) by CUBUL74 programs should bé Prépared to actept this 
mossage type. Such 4 aessage wilt be received infreduentty since 
@ precondition for its generator its afi at€eapted SEND tod a 
station Cowned By this NES) from which no COHOL7¢4 program has yet 
done a RECEIVE. In this situations the ACP does not known whether 
or not access to this station has prevtousty been granted; 
therefore, the message will be forwarded to the MCS who either 
sends it on to the station or discards ite | Howevers the status 
key field» wuhen returned» always indicates that the meSsage was 
sent to the station and there is no reply expected from the MCS. 
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An executing MCS may interface With a user remote file without 
headers through the following record fcrmat: 
Table 6.1 USER-DEFINED MESSAGE 
NC“-MCS MCS-NC MCS“USER USER-MCS FIELD LENGTH 

: R W R W R 86 R PIC 
MESSAGE.TYPE te ts +. + (*) (*) «* 99 
VARTANT * * t & * = = | 9 
LSN & ts & t te {*) (*) te 999 
TEXT.SIZE & * + . + (*#) («) te 9€4) 
REMOTE.FILE.NO te * & * + = - 999 
TIME * * - 7 9(7) 
TRAN.JNOG & * a ica 999 
ERROR * * = = XX 
TALLYS t & & * = = 9(€9) 
TOGGLES * t t * = = 9(5) 
TERMINAL.TYPE te * = = 39 
FILLER XCo) 
TEXT t * t cd te tt * te XCTEXT.SIZE) 
The semantics of the fields of the USER“DEFINED message record 
are: | : | 
MESSAGE.TYPE Established by the user program and must 


be a number 
than 100. 


greater than 49 and tess 
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TEXT 3~4 
TEXT.SIZE 373 
TIME 3°39 4°25 
TOGGLE 374 : 
TRAN.NO 373 
USE 577 | 
USE -REMCTE.KEY 4-5 
USER MESSAGES 671 
UStR.QUEUE .NO = a | 
USER RENOTEeFILE.NO 4e5 
VARIANT 3-3. : | 
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